Scenario #4000: Create Membership for Partner

UseCase Create Membership => Membership: M-3101000 - Test AG

Properties

Required

• Partner: P-31010 - Test AG from 1010: Create Legal Person As Partner

Given

name	value
partnerName	Test AG
validFrom	2020-10-15
newStatus	ACTIVE
membershipFeeBillable	true

Partner: Test AG

HTTP GET "/api/hs/office/partners?name=Test+AG" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "ceaf680a-e52e-4625-b80f-fe70a66e6428", // Partner: P-31010 - Test AG
  "partnerNumber" : "P-31010",
  "partnerRel" : {
    "uuid" : "d8468486-cc0a-4797-b367-4c393953f190", // partnerRelationUuid
    "anchor" : {
      "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "1223603d-1a3b-4e0c-a244-027585d22eb2", // Person: Test AG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Test AG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "c9fdae44-bedc-4fb6-b5ad-f7016218fc25", // Contact: Test AG - China
      "caption" : "Test AG - China",
      "postalAddress" : {
        "country" : "China",
        "province" : "Guangdong Province",
        "city" : "Dongguan City",
        "street" : "No.2 Commercial Second Street",
        "district" : "Niushan Wei Wu",
        "department" : "Executive Board",
        "building" : "Thi Chi Koh Building"
      },
      "emailAddresses" : {
        "main" : "norden@test-ag.example.org"
      },
      "phoneNumbers" : {
        "phone" : "++15 999 654321"
      }
    }
  },
  "details" : {
    "uuid" : "c0e8a6b5-877b-4ced-a480-4edf988d3681",
    "registrationOffice" : "Registergericht Hamburg",
    "registrationNumber" : "1234567",
    "birthName" : null,
    "birthPlace" : null,
    "birthday" : null,
    "dateOfDeath" : null
  }
} ]

In production, data this query could result in multiple outputs. In that case, you have to find out which is the right one.

Create Membership: M-3101000 - Test AG

HTTP POST "/api/hs/office/memberships" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  -H 'Content-Type: application/json' \
  --data-binary @- <<EOF
{
  "partner.uuid" : "ceaf680a-e52e-4625-b80f-fe70a66e6428", // Partner: P-31010 - Test AG
  "memberNumberSuffix" : "00",
  "status" : "ACTIVE",
  "validFrom" : "2020-10-15",
  "membershipFeeBillable" : "true"
}
EOF
=> status: 201 CREATED 1c32881f-9f33-4750-bd6f-cb303a6adf63

Verify That the Membership Got Created

HTTP GET "/api/hs/office/memberships/1c32881f-9f33-4750-bd6f-cb303a6adf63" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "1c32881f-9f33-4750-bd6f-cb303a6adf63",
  "partner" : {
    "uuid" : "ceaf680a-e52e-4625-b80f-fe70a66e6428", // Partner: P-31010 - Test AG
    "partnerNumber" : "P-31010",
    "partnerRel" : {
      "uuid" : "d8468486-cc0a-4797-b367-4c393953f190", // partnerRelationUuid
      "anchor" : {
        "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "1223603d-1a3b-4e0c-a244-027585d22eb2", // Person: Test AG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Test AG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "c9fdae44-bedc-4fb6-b5ad-f7016218fc25", // Contact: Test AG - China
        "caption" : "Test AG - China",
        "postalAddress" : {
          "country" : "China",
          "province" : "Guangdong Province",
          "city" : "Dongguan City",
          "street" : "No.2 Commercial Second Street",
          "district" : "Niushan Wei Wu",
          "department" : "Executive Board",
          "building" : "Thi Chi Koh Building"
        },
        "emailAddresses" : {
          "main" : "norden@test-ag.example.org"
        },
        "phoneNumbers" : {
          "phone" : "++15 999 654321"
        }
      }
    },
    "details" : {
      "uuid" : "c0e8a6b5-877b-4ced-a480-4edf988d3681",
      "registrationOffice" : "Registergericht Hamburg",
      "registrationNumber" : "1234567",
      "birthName" : null,
      "birthPlace" : null,
      "birthday" : null,
      "dateOfDeath" : null
    }
  },
  "mainDebitor" : null,
  "memberNumber" : "M-3101000",
  "memberNumberSuffix" : "00",
  "validFrom" : "2020-10-15",
  "validTo" : null,
  "status" : "ACTIVE",
  "membershipFeeBillable" : true
}

---

generated on 2026-07-17 01:42:27 for branch